Создание центра затрат

Запрос позволяет создать новый центр затрат в справочнике.

Синтаксис запроса

POST https://b2b-api.go.yandex.ru/integration/2.0/cost_centers/create

Заголовок запроса

Authorization: Bearer <OAuth-токен>
Процесс получения токена описан в разделе Начало работы.

X-YaTaxi-Selected-Corp-Client-Id — ID клиента из Личного кабинета. Обязателен, если по токену доступно несколько клиентов.

Тело запроса

Данные о заказе передаются в формате JSON:

Поле	Описание	Формат	Обязательность
`name`	Признак, используется ли данный центр затрат по умолчанию (задан при активации сервиса клиенту).	Строка	Да
`default`	Признак, используется ли данный центр затрат по умолчанию (задан при активации сервиса клиенту).	Булево	Да
`field_settings`	Список настроек для каждого поля центров затрат.	Массив объектов	Да

Структура элемента массива field_settings:

Поле	Описание	Формат	Обязательность
`hidden`	Не показывать и не использовать это поле при заказе.	Логическое	Нет
`title`	Название поля.	Строка	Да
`required`	Обязательно ли заполнять это поле при заказе.	Логическое	Да
`services`	Идентификаторы сервисов, в которых можно использовать это поле при заказе. Возможные значения: `taxi`: Яндекс Go; `eats2`: Яндекс Еда и Яндекс Лавка; `grocery`: Яндекс Лавка; `drive`: Каршеринг; `tanker`: Яндекс Заправки; `cargo`: Грузоперевозки; `travel`: Яндекс Путешествия; `scooters`: Яндекс Самокаты.	Массив строк	Да
`format`	Возможные значения: `select` — сотрудник выбирает кост-центр из списка; `text` — сотрудник самостоятельно указывает кост-центр в текстовом поле; `mixed` — сотруднику доступны выбор кост-центра из списка и свободный ввод в текстовом поле.	Строка	Да
`values`	Cписок кост-центров, доступных для сотрудника. Формат списка "кост_центр1","кост_центр2", ....	Массив строк	Да
`id`	Идентификатор настроек поля.	Может быть как осмысленной строкой, так и UUID	Нет

Описание полей ответа

В ответе могут содержаться следующие поля:

Поле	Описание	Формат
`id`	Идентификатор центра затрат.	Строка

Пример запроса

POST https://b2b-api.go.yandex.ru/integration/2.0/cost_centers/create
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>

  {
    "name": "Regular cost center",
    "default": false,
    "field_settings": [
      {
        "title": "Центр затрат",
        "required": true,
        "services": [
          "taxi",
          "eats2",
          "cargo"
        ],
        "format": "select",
        "values": [
          "По работе",
          "Не по работе"
        ],
        "id": "cost_center",
        "hidden": true
      },
      ...,
      {
        "title": "Параметр123",
        "required": false,
        "services": [
          "taxi"
        ],
        "format": "text",
        "values": [],
        "id": "d9b2cf97-...-7dbfd2524699",
        "hidden": true
      }
    ]
  }

Пример ответа

Пример ответа на данный запрос выглядит следующим образом:

{
    "id": "2983f...403ecf"
}

Возможные коды ответа

Ответ на данный запрос может содержать следующие стандартные HTTP-коды:

200 — запрос выполнен успешно.
400 — в запросе был передан неизвестный параметр или параметр с недопустимым значением.
403:
- SELECT_CLIENT_HEADER_REQUIRED — в запросе не передан заголовок X-YaTaxi-Selected-Corp-Client-Id (возвращается в случае, если для токена доступно более одного клиента).
- SELECTED_CLIENT_ACCESS_DENIED — в заголовке X-YaTaxi-Selected-Corp-Client-Id передан ID клиента, к которому нет доступа у этого логина.
404 — объект не найден.
406 — обновление центра затрат с переданными параметрами недоступно.
409 — конфликт при обновлении центра затрат.

Была ли статья полезна?

Изменение персональных лимитов

Обновление центра затрат